INTRODUCTION 

What tOutliner can do for you. 

tOutliner will read a file created by you with your word processor 
and allow you to display its headings and sub-headings in collapsed 



or expanded fonats. It will also alio* you to delete, insert, 
copy, »ove, and even change the "level" of a heading (prolate or 
deiote it). It Kill also allot) you to edit a particular heading; 
insert, delete, or overtype. Your changes can be saved to disk, and 
headings sent to your printer. A siiple notation systet Nil! let you 
knoM whether a particular heading has sub-headings, and whether they 
are presently displayed or not. Each node, lain, edit, and buffer 
has its own menu to select fro*. This is probably the only tint you 
Nill need to refer to this doeuientation. 

Hardware requirements 

Hininui; 

tOutliner nill run on a one drive 64K Radio Shack Model 4, 

Recoraended: 

+0utliner dill be lost useful on a two drive 128K Radio Shack Model 

4. 

Software requirements 

Minimis; 

A word processor (tOutliner reads pure ASCII files only! and TRSDOS 

6.2 or LS-DOS 4.3 

Reconended: 

A word processor and DoubleDuty (Tandy/Radio Shack catalog number TX 

76102). 

Hhile +0utliner nill run with less than the recowended hardware and 

software it will not be nearly as useful to you, 

STARTINS tOUTLINER 

Froi DOS siiply type OUTLINER "Filenaie" where filename is the naie 
of either a previously created ASCII file or one you wish to 
create. Do not type the quotation narks. If you do not follow 
OUTLINER with a filename you will be proapted for one. If you are 
creating a new file you will be asked to confim your choice, type in 
a new filenaie, or return to DOS. You can also switch disks, key in 
<§> and search the new disk for your file. In all cases press the 
<ENTER> after your choice. 

COMMAND CONVENTIONS 

The keys displayed on the last line of the video screen and enclosed 
with "<" and *>" syibols or displayed in reverse video are your 
eoiiand choices. <shifted arrow> Beans you iay hold down the shift 
key and siiultaneously press an arrow key. Nuibered keys preceded by 
an F (<F1>) refer to the function keys above the separate nuibers key 
pad of your key board. 

Sote keys not listed in the ienu line will also be active. In the 
■ain lode, the arrow keys will love the line cursor up and down. The 
shifted up or down arrow will iove the cursor up or down a video 
screenful. The space bar will be treated as a <down arrow) key. 

While in edit iode, the <enter>, the <up arrow) or <down arrow), and 
the <F3> key will all exit the edit »ode and return you to the uain 



While in the buffer »ode, any key not displayed on the ienu will 
return you to the lain ienu. 

Headings displayed by +0utliner will be preceded by either a "+" or a 
*-" symbol. Headings preceded by a "t" have subheadings (whether 
currently displayed or not!. Headings preceded by a "-" have no 
sub-headings. 



CSEAT1NS THE OUTLINE FILE 

The first step in using the tOutliner prograi is to create a file for 
it to read. There are two ways to do this. The first, and best, is 
to create it with a word processor, save it to disk in ASCII foriat, 
then read it with tOutliner, The tOutliner file will have each 
heading on a separate line. Each heading my not be sore than 80 
characters long. Lines longer than 80 characters (this includes 
leading spaces! will generate an error. Sub-headings will be 
indented two spaces right of their headings. An exaiple file will 
look like this: 

INTRODUCTION 
History of the woibat 
Early history 
Recent history 
Future of the woibat 
CURRENT N0M8AT TECHN0L06Y 
Laser technology 
Maglift technology 
FUTURE KOrlBAT TECHNOLOGY 
Russian advances 
Canadian advances 
American advances 
Bovernient projects 
Private projects 
RECOMMENDATIONS 



Once read by tOutliner this file will be displayed in the following 
Banner: 

t INTRODUCTION 
t History of the woibat 

- Early history 

- Recent history 

- Future of the woibat 

t CURRENT HOMBAT TECHN0L0SY 

- Laser technology 

- Maglift technoloby 

t FUTURE MMBAT TECHNOLOBY 

- Russian advances 

- Canadian advances 
t Aierican advances 

- 6overn»ent projects 

- Private projects 
- RECOMMENDATIONS 



The second nay to create an +0utliner file is to select a new 
filena»e (fro« DOS, e.g. QUTLINER "FILENAME/TAN:1" or when prompted 
by tOutliner). Mien +0utliner doesn't find the file on any of your 
available drives, select the "i" (new file! option. You will be 
presented with ten lines of exclamation narks. You can then edit 
each line (overtype, delete, insert, etc.). Save this neN file to 
disk when proapted. 

No Batter hon you create your initial file, the following »enu Hill 
also be displayed on the botto* line of your screen: 

Collapse 6Collapse Expand Delete Insert F3Edit Buffer Print TOT Load 
Save Quit 

The key that activates the particular function will be in reverse 
video. 

Rt»e»ber that headings will be preceeded by either a *+• or a 
"-". Headings preceded by a *+" have sub-headings. Headings 
preceded by a '-* have no sub-headings. 



+0UTLINER COMMANDS 

The <arrow> and <shifted arrow) keys. 

You nay love the "bar" cursor by using the <up arrow), the <down 
arrow) or the (shifted arrows). Arrow keys will »ove the bar cursor 
one heading up or down. The keys repeat. Shifted arrows work this 
way: if the cursor is not at the top or bottou of the display then 
it will be loved there. If the cursor is already at the top or 
bottoe of the display when the <shift arrow) is pressed, then the 
display will shift an entire screenful in the appropriate direction, 
or to the very top or end of the file, whichever would occur 
first. If the <arrows) or the (shifted arrows) are pressed and the 
cursor cannot »ove in that direction then a warning will ioaentarily 
replace the §enu line at the bottoi of the screen. It will read 
"Nothing Above* or "Nothing Below." 

<C)ollapse. 

The <C> key will collapse the heading indicated by the cursor. Using 
the above example, placing the cursor on the heading "+ INTRODUCTION" 
and pressing the <C> key would result in the following screen 
display: 

+ INTRODUCTION 

+ CURRENT WOMBAT TECHNOLOGY 

- Laser technology 

- Maglift technoloby 

+ FUTURE WOMBAT TECHNOLOGY 

- Russian advances 

- Canadian advances 
+ Aierican advances 

- Bovernient projects 

- Private projects 
- RECOMMENDATIONS 



The headings under "♦ INTRODUCTION" have been lade invisible. 

<6>lobalCoIlapse key. 

The <6> key will collapse the entire outline file. The cursor will 
return to the topnost itei, 

<E)xpand key. 

The <E> key will expand the heading and display subheadings. 

<D)elete key. 

The <D) key will delete the heading highlighted by the cursor, 
provided it or the heading on the line above are not 
collapsed. Collapsed headings and headings on a line following a 
collapsed heading cannot be deleted. You iust expand then first. In 
the following exaiple," + INTRODUCTION" could not be deleted because 
it is a collapsed heading. Neither could "+ CURRENT NOMBAT 
TECHNOLOBY" since it is on a line iwediately below a collapsed 
heading. You oust expand the "+ INTRODUCTION" heading before 
deleting either. An appropriate nessage will wwentarily replace the 
•ain »enu line should you attespt to delete one of these headings. 

jcpll 

+ INTRODUCTION 

+ CURRENT NOMBAT TECHNOLOSY 

- Laser technology 

- Maglift technoloby 

t FUTURE NOMBAT TECHNOLOSY 

- Russian advances 

- Canadian advances 
+ Aierican advances 

- Sovernnent projects 

- Private projects 
- RECOMMENDATIONS 

<I)nsert key. 

Pressing the <I) key will allow you to insert a new heading above the 
present cursor position. If the heading above is collapsed you will 
be asked to expand it before being allowed to insert. In the 
following exaiple, you would not be permitted to insert a heading 
between the first and second heading. You would have to expand the 
"♦INTRODUCTION" heading first. A warning message will te*porarily 
replace the lain lenu line should you atteipt to do this, 

+ INTRODUCTION 

+ CURRENT NOMBAT TECHN0L06Y 

- Laser technology 

- Maglift technoloby 

+ FUTURE NOMBAT TECHNOLOSY 

- Russian advances 

- Canadian advances 
+ Aierican advances 

- Bovern»ent projects 

- Private projects 



— 



- RECOMMENDATIONS 

You would be able to insert a line between *- Russian advances" and 
"- Canadian advances." Place the cursor over the heading 
"- Canadian Advances" and press the <I> key. A "- !!!!" will appear 
above the cursor position and you will be placed in edit lode. The 
screen should now loot like this: 

♦ INTRODUCTION 

+ CURRENT HOMBAT TECHNOLOGY 

- Laser technology 

- Mag lift tecbnoloby 

+ FUTURE HOMBAT TECHN0U6V 

- Russian advances 

- i m 

- Canadian advances 
+ American advances 

- 6overnaent projects 

- Private projects 

- RECOMMENDATIONS 

The edit aenu would also replace the sain ienu at the bottoi of your 
screen. The edit ienu looks like this: 

IEDIT* <arrow> {shifted arrow) <Fl>Insert is ON <F2>Delete <F3>Qui«- 

Edit JEDIT* 

Parts of the edit aenu will be in reverse video. 

Type in your new heading, overstriking the four exclaaation narks. 

To exit edit, press <F3) , <ENTER> or either the <up> or <down 
arrow). 

See the following section of this docuaentation for more information 
on the edit lode. 

<F3)Edit node. 

As tentioned above, inserting a new heading into the outline 
autoaatically places you in edit lode. You you can also enter edit 
lode by pressing the <F3> key while in the Bain semi node. You will 
then be able to edit the heading you have highlighted with the bar 
cursor. The edit »enu will replace the aain menu at the bottoi of 
your screen. The edit aenu looks like this: 



•EDIT* <arrow> {shifted arrow) <Fl)Overstrike is 

<F3)Quit Edit (EDIT* 

Parts of the edit ienu will be in reverse video. 



<F2)Delete 



The bar cursor will disappear and a saall underline cursor will flash 
under the first character of the heading being edited. While in the 
edit node the following keys are active: 

The <right> or <left arrow) will move this cursor. 

The <shifted arrows) will "proiote" or "denote" the heading-indent 
it to the left or to the right. (The "+" or •-• status of the 
surrounding headings will be adjusted when you leave edit aode.) 



<Fl>Insert. The <Fi> key acts as a toggle. Press it once and any 
character you key in will be inserted just ahead of the 
cursor. Press it again and any key you type will overwrite 
characters on the screen. You will know whether you are in insert or 
overstrike node by looking at the edit aenu on the last line of the 
video. The words "Insert is ON" or "Overstrike is ON" will appear 
after the "<F1>" aenu choice, depending on the state of the insert 
toggle. 



<F2>DeIete. 
the cursor. 



Pressing the <F2> key will delete the character under 



<F3)0uit. Pressing the <F3> key will return you to aain senu node. 
You can also press <ENTER>. or either the <up> or <down arrow) to 
leave edit node. If you promoted or demoted the heading while in edit 
•ode, the "*" or "-" status of the surrounding headings will be 
adjusted when you re-enter aain aenu aode. 

<B)uffer. 

Pressing the <B) key while in the aain aenu lode will display the 
following aenu on the last line of the video screen: 

<Copy Move Here Show Buffer) 

Parts of the buffer aenu will be in reverse video. 

Pressing the <C)opy key will copy the current cursor line into the 
"buffer* and return you to the aain aenu. 

Pressing the <M)ove key will copy the current cursor line into the 
buffer, erase that line froa the screen, and then return you to the 
aain aenu. 

Pressing the <H)ere key will insert the current contents of the 
buffer on the line just above the current cursor line, then return 
you to the aain aenu. All lines below the inserted line will be 
shifted down a line, - 

Pressing the <S)how Buffer key will display the current contents of 
the buffer for a few seconds then return you to the aain ienu. 

Copying and aoving lines requires two-key conbinations. The first 
key is always the <B) or the Buffer key. For exaaple, if you wish to 
aove a line froa one location to another you would place the bar 
cursor on the line you wish to aove then press <B) followed by 
<M>. This copies the line into the buffer and erases it froa its 
screen location. You will be returned to the aain aenu. Now aove 
the cursor to the line just below where you wish the line to go. Now 
press <B) followed by <H> (for Here) and the line will be copied to 
the space just above the cursor. Copying lines works the same way 
except that the original line is not erased. 

You can copy the contents of the buffer as aany tiies as you 
wish. The buffer does not change until you press either the <8)<C) 
or the <BXM) combination again, after which the buffer contents will 
contain a new line. You can always press <8><S> to see the current 
contents of the buffer. 



You cannot move a collapsed heading, You cannot "<H>ere' the buffer 
contents to a collapsed heading. If you attempt to, a warning 
message dill flash on the bottom line, Simply expand the heading in 
question first, 

<P>rint. 

Pressing the <P> key while in the main ienu mode will print the 
outline as displayed. Headings under collapsed headings will not be 
printed. Mo special formating is permitted. There are no "skip 
perforations', or special printer widths supported. If you need a 
special printed version of your outline, use your word processor on 
the file. 

<T>0F 

Pressing the <T> key will send a Top Of For* character to your 
printer. See your TRSDOS manual for more details. If your printer 
is not on line, a message saying so will appear on the last line of 
your screen. 

<L>oad. 

Pressing the <L> key will allow you to load a new file. If you have 
lade changes (if you used the Insert, Delete, or Edit options of the 
•ain menu) you will be" asked if you wish to save the file currently 
in memory. Then you will be asked for the filenaie you wish to load. 

<S>ave. 

The <S> key will allow you to save the file currently in memory. You 
can save the outline in memory using the original filename (this is 
the default) or select a new name. You can also return to the sain 
menu at this point by giving the single letter "h" at the filenaie 
prompt. 



<Q>uit. 

<B>uit allows you to exit the program, 
to save changes. 



LIMITATIONS OF +0UTLINER 



You will be asked if you wish 



Filesize is United to 25,000 characters. This should still take 
care of most people's needs. 

The screen reprinting routines (after a screen scroll, a delete or an 
edit! are relatively slow. 

As already mentioned, printing to your printer is not formatted in 
any way. 

Again, any fancy formating can always be done with your 
wordprocessor. 

There is no "print to file" feature yet. 



TYPICAL SESSION 

I have borrowed heavily from the following two books for this 
section. The first is The Scholar's Personal Computing Handbook: A 
Practical fiuide by Bryan Pfaffenberger, Boston! Little, Brown and 
, Co., 1986. The second is The Whole Earth Software Catalog for 1986 
edited by Stewart Brand. Garden City, NY; Quantum Press/Doubleday, 
1985. 

Hith a new writing project to begin, I load DoubleDuty. I then load 
ny text editor in BOTH partitions, (I use Allwrite by ProSoft). I 
use partition 1 to store what will become my outline and partition 2 
for what will be the actual text. I "brainstorm" in partition 1. I 
think of headings or topics, and type, type, type. 1 limit the 
typing in this section to 80 characters per line. Sraduaily a 
pattern takes place. I promote headings, shift them about, move some 
ideas under others. If a certain idea or heading gets my juices 
flowing 1 transfer to partition 2 and type away there. Again, 
neither partition is very structured. The idea is to keep the 
thoughts flowing. 1 do, however, keep headings in one partition 
(partition 1) and supporting text, or "flesh for the bones of the 
outline" in the other partition. 

Until the outline file becomes longer than 25 lines (a video 
screenful! there really isn't any need for an outlining 
program. Your wordprocessor can edit the outline much better than 
+0utliner could. Once your outline gets larger than that, however, 
you will appreciate the ability to collapse and expand 
headings. Collapsing will allow you to regain the sense of the 
overall structure of your writing, without getting lost in the detail 
of subheadings. You can expand any heading that you are curious 
about. Khen I get to this stage I quit the wordprocessor in 
partition 1 and load tOutiiner instead. Now I can switch back and 
forth between the outline and the actual text. I print a hard copy 
of the outline with only the section I a* currently working on 
expanded and the rest of the outline collapsed. This way, structure 

becomes very apparent and it becomes easier to stay on the 

topic. Although switching back and forth from one partition to the 
other is very fast, 1 find it so such easier to look at paper than a 
screen. 

Actually writing the text inevitably causes me to alter the 
outline. If the outline change is minor, I switch to that 64K bank 
and use +0utliner to make the changes. If the changes are major (and 
they often are! 1 quit tQutliner and use ty wordprocessor to make the 
changes. Experience will tell you when to use which method. 

This "typical session" assumes that you have the recommended hardware 
and software. If you don't, I'm not sure the hassle of alternately 
loading your wordprocessor and the +0utliner program and their 
attendant files is worth it. You're welcome to try, however. 



MAT IS FREEWARE? 

You may copy this software at will. Pass it on to friends. Upload to 



any bulletin board. If you find it useful send a donation to; 



Expand a heading. 



Kevin Kierans 
2343 Nechako Drive 
Kailoops, B.C. 
CANADA V2E 1T8 

If you send more than $7.49 US or $9.99 Canadian 1 will place you on 
■y nailing list and notify you of upgrades and bugs. You mil 
receive upgrades free of charge. See the final section for proposed 
enhancesents. Don't hesitate to suggest improvements or report bugs. 
If SOHEONE sends $1.00 I (till finally be able to answer "Yes!" to sy 
wife's "Nice hobby, I'i sure. Any loney yet?" 

FUTURE ENHANCEMENTS 

Display directory 

Display OUTLINER data files one at a tine and allow selection 
with a single keystroke. iSimilar to <right arrow) in Visicalc (U).l 

Global Expand 

Expand outline fully with one keystroke. 

Tag headings for lass action 

Tag headings (a ">" sysbol would appear after the "+' or 

"-■). Tagged headings could then be "gathered" together and then 

either copied or soved to a new location. 

Print to file 

Print to file as well as to printer. Option to print headings with 
preceeding nuibers or letters, i.e: 
I. Hajor Heading 
A. Subheading 
i. Next level 

a, Next level etc. 

HESSA6ES AND COMMANDS 

Here is a list of valid +0utliner cowands. Underlined coiiands 
operate in the edit or buffer »odes only. 

The <up/down arrow) and <shifted up/down arrow) keys. 

Hove the bar cursor. 
<S)lobalCol lapse 

Display only lajor headings. 
<C)ol lapse. 

Collapse a heading. 
<E)xpand key. 



page. 
<D)elete key. 

Delete a heading. So« collapsed headings, and sue headings 
near collapsed headings nay not be deleted until expanded. 

<I)nsert key. 

Insert a heading. You nay be asked to expand certain headings 
before inserting. Insert places you in <F3)Edit node. 

<F3)Edit node. 

Edit a heading. See underlined coiiands. 
<right) or <left arrow) 

Hove the edit cursor. 
The <shifted arrows) 

Promote or denote a heading. 
<Fi>Insert 

Turns insert toggle on/off, 
<F2)Delete 

Deletes character 4inder the edit cursor, 
<F3)Quit 

Quit edit node. Adjust the "+" or •-■ status of surrounding 
headings. 

<Enter> 

Quit edit node. Adjust the ■+■ or •-• status of surrounding 
headings, 

<up/down arrows) 

Quit edit lode. Adjust the *♦' or •-* status of surrounding 
headings, 

<B)uffer 

Buffer aenu. See underlined counands below, 
<Oopy 

Copy the current line to the buffer. 
<H)ove 



Copy the current line to the buffer and then delete line froa 
screen. 

<H>ere 

Copy the current buffer contents to the line above the cursor. 

<S>how Buffer 

Display the current buffer contents. 
<P>rint 

Send outline to printer with current collapsed/expanded forsat. 

<L>oad. 

Load another outline file. 
<S>ave. 

Save the file currently in ieaory. 
<Q)uit. 

Return to TRSDOS. 

Here is a list of tessages you might encounter while using +0utliner: 
Nothing to collapse 

The heading has no sub-headings. 
Nothing to expand 

The heading has no sub-headings. 
Nothing above 

You've reached the top of the file, 
Nothing below 

You've reached the bottoa of the file. 
Can't delete collapsed heading 

You must expand before deleting. 
Can't delete or uove below collapsed heading 

You lust expand before deleting. 
Can't insert above top of screen 



You Mist scroll up first. 
Expand upper heading first 

You lust expand before inserting or iioving. 
Expand before changing level 

You sust expand before "prosoting* or "denoting" a heading. 
Line too long 

You »ust shorten this line before "promoting" or 'demoting" it 
Can't have an outline with one heading 

You aust have at least two headings for an outline. 
File not found 

You have the wrong disk in the drive or have nade a filenase 
error. 

Disk full 

Change disk and try again or delete an unused file. 
Printer not ready 

Hake sure printer in on line. 
File too siall 

You wist have at least two headings for an outline. 



(Decesber 10th, J986) 
[January 20th, 1987) 
SHarch 7th, 1987) 



